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I . SCOPE 


This document updates the existing monthly weather and yield data bases for the 
United States by 'inserting data for additional model areas in Montana^ South 
Dakota, Oklahoma, Nebraska and Colorado. The data base design is identical to 
that previously documented for the U.S in the As-Built Design Specification for 
the Yield Estimation Subsystem (YES) Monthly Yield Data Base and Supporting 
Programs" (JSC.42537/LEC-10034) . 



/ 


2. APPLICABLE DOCUMENTS 


Action Documentation 63-1347-4963-12 

"As-Bullt" Design Specification for the Yield Estimation Subsystem (YES) Monthly 
Data Base and Supporting Programs'* (JSC-12537/LEC-10034) . 


3. SYSTEM DESCRIPTION 


3 • 1 HARDWARE D E SCRIPTION 

These data and supporting programs previously documented In ''As-Bullt Design 
Specification" (JSC-12537/LEC- 10034) , are resident on the IBM 360/195 complex 
at Suitland, Maryland. They iihould be transferable to any IBM 360-370 series 
machine with sufficient disk to handle the data base and main memory to support 
the PL/ I optimizing compiler. 


3.2 DATA BASE STRUCTURE 

The monthly weather and yield data base is a tree structure, with nodes, or 
levels, being the country, region, zone and strata. The four respectively 
represent: the United States, the Great Plains, states and crop reporting 

districts (CRD’s). 


3.2.1 DATA BASE STORAGE REQUIREMENTS 

The data base storage requirements remain the same as those for the U.S. described 
in "As-Built Design Specification." 


3.2.2 CONTROL AND DIRECTORY BLOCKS 

Tlie format for the control and directory blocks follows that previously defined 
in "As-Built Design Specification." The U.S, directory block originally contained 
the additional CRD's, and no modification to either control or directory block 
was necessary. 


3.2.3 DATA DESCRIPTORS AND DATA BLOCKS 

The format for the data descriptors and data blocks follows that previously defined 
in "As-Built Design Specification." 


3.2.4 MODEL DEFINITION BLOCK 


Structure is pi-ovided to allow inclusion of model definitions. 


4, OPERATION 


^•1 DATA BASE INITIALIZATION AND DEFINITION 


Data base initialization and definition were accomplished using the supporting 
programs documented in "As-Built Design Specification" (JSC-12537/LEC-10034) . 
Only data descriptor definition was required, as the original U.S. control block 
and directory definitions had reserved space for these additional CRD’s. 


4.2 DATA CONVERSION 

Data for all new United States CRD’s located at CCEA in Columbia, Missouri, exist 
in English units and in a format different from that required for inclusion in 
the data base. Eight programs were written to handle the necessary conversions 
to the required format: METOf<E (Montana, South Dakota meteorological data), 

METTWO (Oklahoma, Nebraska meteorological data), 

METCOLO (Colorado meteorological data) , 

, YLDONE (Oklahoma, Nebraska yield data), 

YLDTV/0 (South Dakota yield data) , 

COLOYLD (Colorado yield data) , 

MONTYLD (Montana yield data) , 

DEGDAZE (degree days for all states) . 

Converted data were stored on a catalogued disk file, and transferred to the 
data base disk file when all conversions were completed. 

Sample listings and flowcharts appear in Appendix C. 


^ • 3 data base I.OAPING 

Data for new model areas were loaded using the updating program UPDDATA, documented 
in "As-Built Design Specification." 


DATA BASE LISTING 

Three programs documented in "As-Built Design Specification" accomplish listing 
of control block and directory Information (YESLS02 and YESLS04, respectively), 
as well as the data itself (LISTJOB) . 


APPENDIX A 
STRUCTURE 



United Statee Data Year Entry 

There Is a maximum of 47 years following the data descriptor entry in a data 
block for each United States region; each year entry is 128 bytes long. 


DCL I US, 

2 YEAR 
2 NXTYRREC 
2 NXTYRDISP 
2 FILLER 
2 MEANTEMP(12) 

2 PRECIP(12) 

2 DEGREEDAY(12) 
2 HARVESTED (4) 

2 PLANTED(4) 

2 PRODUCTION (4) 


FIXED BIN(15,0), 
FIXED BIN(15,0), 
FIXED BIN(15,0), 
FIXED BIN(15,0), 
FIXED BIN (15,0), 
FIXED BIN (15,0), 
FIXED BIN(15,0), 
FIXED BIN(31,0), 
FIXED BIN(31,0), 
FIXED BIN (31,0); 



APPENDIX B 
VARIABLE CODES 



r 


Mateorological Variables 


PreclrlCabion 5 
(tean CemperaCure 35 
Degree days above 40 


Yield Variables 

Harvested 101 
Planted 102 
Production 103 


Crops 

Spring wheat 201 

Winter wheat 202 


Units of Measurement 


Monthly 5 
Millimeters 201 
Quintals 228 
Hectares 236 
Degrees Centigrade 241 


Others 


Monthly 

26 

Year 

61 

Pointer 

90 

Record pointer 

91 

Displacement pointer 

92 

Filler 

99 


APPENDIX C 

CONVERSION PROGRAM FLOWCHARTS 
AND LISTINGS 
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PL/I OPTIMIZING compiler METCOLO: PROC OPTIONS (MAIN) 
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